perm filename DIRED.SGK[UP,DOC]1 blob sn#117008 filedate 1974-08-30 generic text, type C, neo UTF8
COMMENT ⊗   VALID 00005 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	Description
C00007 00003	Switches
C00012 00004	The commands
C00017 00005	Monitor Command Line and Temp Core files
C00019 ENDMK
C⊗;
Description

    No claim is made for spelling.  If you don't like it, fix it

	Dired is a  "Directory Editor".  It is  operationally similar
to  E.  It  displays a list  of the files  in a  given directory, and
permits you to modify this display to modify the state of your files.
By deleting a  line of display, you delete the  file described on it.
Giving  a negative  argument  to the  delete command  "undeletes" the
specifed number of files, thus delete is a non-dangerous  thing to do
in Dired,  since it can always  be undone. By editing a  line (as you
would with E) you rename  it.  This allows  you to change the  file's
names, PPN, protection, date,  and time.  Files which are  in use, or
protected against you are not displayed.
	The files  are displayed  in alphabetic  order by file  name.
They  can be  displayed in order  of date  last written by  using the
/DATE SORT  switch.   The /REVERSE  SORT switch  (sticky) causes  the
files to be displayed in reverse order.
	A mask facility is provided.  The mask can be specified while
running, or in the  monitor command line, in the form of a file name.
* matches any file  name as in  COPY (i.e. DEL, DIR,  REN, COPY).   ∀
matches any character in a file  name.  The mask FUBAR∀.* causes only
files whose first 5 letters are FUBAR to be displayed.
	A similar mask facility exists for PPN's as for file names. ∀
or ?  matches any character, and as in COPY  * matches any name.  The
PPN [* implies all of your areas, as in COPY.  The PPN [? implies all
of your areas with a single character project name.
	A word about deleteing:  when a line of text  is deleted from
the  display,   the delete  does not  actually take  place.   All the
deletes done are added to a "delete list" which is run  when exiting,
switching PPN's, or switching devices  (UDP/DSK). The delete list can
be edited using the /SHOW command. (see /SHOW switch) The delete list
can be cleared with the command /ABORT, which appears  to the user to
have the effect  of undoing all the deletes done  since the last time
the delete list  was run. Giving  a negative argument  to the  delete
command "undeletes" files. This is done by  revmoing |ARG| files from
the bottom  of the delete list.  The delete  list can be run by using
the extended command /DELETE. 
	The following is a list of the  descriptions of the enties in
each line of directory information displayed by Dired:

First File Name
Extension
PPN
File Size
Date Last Written
Time "  	"
Protection
Date Last Dumped followed by a P or T indicating dump class
Number of times file on a permanent class dump tape.
Switches

    No claim is made for spelling.  If you don't like it, fix it

	The following are the available switches.   They can be typed
at  the monitor  command line,  or while  running the  program unless
otherwise noted.  Only enough of the command to make it non ambiguous
need be typed.

/ABORT
	Clears the  delete list.   Like giving an  argument of  -∞ to
the delete command (not switch).


/ALPHA SORT
	Causes the files to be displayed in alphabetic order.


/DATE SORT
	Causes  the files  to  be displayed  in  order of  date  last
written.


/DELETE
	Runs the delete list. This of course is only meaningful while
running Dired.


/DSK MODE
	Edits a directory on  the DSK.  This is  the default setting.
The device (UDP or DSK) selection is sticky.


/EXTENSION SORT
	This switch controls the  extension sort mode.  When  you are
in  extension sort mode, files  are sorted by extension,  and then by
file name.  Otherwise files are sorted by file name, then extension.
	When this switch is typed,  if you  are already in alpha sort
mode the extension  sort mode bit is complemented. If you are sorting
by date when this switch is typed, you are placed in alpha sort mode,
and extension  sort mode  both.   Simply put, it  does all  the right
things for getting in and out of extension sort mode.  The alpha sort
switch resets extension sort.  i.e. typing /ALPHA SORT will place you
in the normal sort by alpha file names mode, as you are in by default
when you start Dired.



/K MODE
	Complements the mode in  which file sizes are printed.   File
sizes  are printed in  words unless this  switch is  thrown, in which
case files larger  than 1024 are  printed in the  form "69 K",  where
1024. is 1 K.



/READ ONLY or /R	;THIS IS NOT UP YET
	Prevents you from  modifying anything.   If you do  a delete,
the text will disappear, but the delete list is never run.

	
/REVERSE SORT
	Causes the sort direction to be complemented. Displaying your
files in reverse /DATE SORT mode shows the most recent files first.


/SHOW DELETE LIST
	This command switches your display mode between the normal,
and Delete List mode.  In delete list mode instead of displaying your
files, your delete list is shown.  Your delete list contains the
files you have deleted.  These files will be delete when you exit
Dired, unless you undelete them first. While in delete list mode, you
may delete entries from the delete list by using the αβD command.
This has the effect of "undeleting" files. (i.e. you can edit your
editions by going into delete list mode and "deleteing deletes" done
in the past)

/UDP MODE
	Edits a  directory on  the UDP  assigned as  device UDP.   If
typed  while running  and files  have been  deleted from  the current
display, the delete list is run first.
The commands

    No claim is made for spelling.  If you don't like it, fix it

The following commands are the same or close to  the same as they are
in E.

αβE	αβL	αβW	αβV	CR	VT	αβ>	αβ<
αβ≤	αβ≥	FORM	αβT	αβB	αβJ

Dired commands  accepts arguments  in a  simlar way  to E  (<Control>
<Meta><digit>).  This includes αβ- and αβ∞.


The following are descriptions of other commands to Dired.  Below ARG
is used  to mean  the value  of the  argument given  to the  command.
Unless otherwise mentioned, commands given no argument will act as if
an argument of one had been given.

?	HELP

	Will display a screenful of information about the commands.


αβD	DELETE

	This  command when  given a  positive  argument, deletes  ARG
files from your directory.   It behaves in a manner similar to αβD in
E.   Deleteing a  line of  directory information  has  the effect  of
deleteing the file described on it.
	When  given a  negative argument  it  "Undeletes" ARG  files,
undeleteing the  files most recently flushed first.   The way this is
accomplished is  by removing  files from  the delete  list.   When  a
delete command is  typed the information about which  files to delete
is  added to the  delete list, and  this list is ran  when doing such
things as exiting the program, or switching PPN's



αβ|α|βE	THE EXITS

	These are the various ways of exiting  Dired gracefully.  αβE
simply deletes  all the files you have asked  it to during your stay,
writes a TMPCOR file, and exits.
	αE and βE edit the current file,  after exiting gracefully as
above.  They both  start editing  on page  |ARG| of  the file.   They
differ in that βE  edits the file in /R  mode.  (suitable for  pawing
thru a directory to see what's what)
	You can return to Dired from E by typing the extended command
DIRED.  "DI" is non-ambiguous at this time.



αβM	SET MASK

	This  command reads  a  mask  in the  form  of a  file  name.
Anything  that  may have  been specified  in  a command  line  may be
specified here, such as  a PPN, and Switches.   αβMFOO*.*/DATE[69,105
sets the mask  to display only the files that  begin with "FOO", sort
them by date, and get all of this from [69,105].
	This is the  best command to  use when you are  changing your
PPN,  device, or mask.   The "[" command is  useful for changing your
PPN without changing your mask.


[	READ PPN

	Accepts a PPN without changing the mask.  A ] or a CR will
terminate reading of a PPN.  


/	SWITCHES AND EXTENDED COMMANDS

	Typing a / will leave you in the line editor and allow you to
type one or more switches.  Of course a PPN may be specified in this
line also.



αβ≡	DDT

	This enters  the DDT in  your core  image after clearing  the
screen  for you.  It  sets up .JBOPC  so you can return  from RAID by
using the proceed commannd.  You  should not do this unless you  know
what you are doing.

Monitor Command Line and Temp Core files

    No claim is made for spelling.  If you don't like it, fix it

	When you exit Dired, it creates a TMPCOR file containing
information about what you were doing, such as the PPN, where you
were in the display, the sort mode, etc.  When a Dired is started, if
this file exists it is read, and sets these things back to the state
described.  Information given in the command line is used over TMPCOR
information.  The only exception to this is that if you specify a
device in the command line the old PPN (from the TMPCOR file) is
replaced by your current alias (unless you specify another)


	Here are some sample Montior Command Lines:


R DIRED;[105,69
	Edits the directory [105,69]

R DIRED;UDP1:
	Edits your directory (or alias'd directory) on device UDP1:

R DIRED;/EX
	Edits the last directory edited (or your DSKPPN's directory
if you have no TMPCOR file) displaying files sorted by file
extension.